aaaaffffGGGGeeeettttBBBByyyytttteeeeOOOOrrrrddddeeeerrrr(((()))) and aaaaffffGGGGeeeettttVVVViiiirrrrttttuuuuaaaallllBBBByyyytttteeeeOOOOrrrrddddeeeerrrr(((()))) return an integer token
representing the byte order of the samples. This value will be either
AAAAFFFF____BBBBYYYYTTTTEEEEOOOORRRRDDDDEEEERRRR____BBBBIIIIGGGGEEEENNNNDDDDIIIIAAAANNNN or AAAAFFFF____BBBBYYYYTTTTEEEEOOOORRRRDDDDEEEERRRR____LLLLIIIITTTTTTTTLLLLEEEEEEEENNNNDDDDIIIIAAAANNNN.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
aaaaffffGGGGeeeettttSSSSaaaammmmpppplllleeeeFFFFoooorrrrmmmmaaaatttt(((()))) and aaaaffffGGGGeeeettttVVVViiiirrrrttttuuuuaaaallllSSSSaaaammmmpppplllleeeeFFFFoooorrrrmmmmaaaatttt(((()))) return the sample
format and sample width (in bits) for the audio file's _t_r_a_c_k and the
audio buffer, respectively, using the integer pointer arguments. See
aaaaffffIIIInnnnttttrrrroooo(3dm) for an explanation of virtual format.
An AIFF-C file which contains 16 bit sample data would return the value
AAAAFFFF____SSSSAAAAMMMMPPPPFFFFMMMMTTTT____TTTTWWWWOOOOSSSSCCCCOOOOMMMMPPPP in the location _s_a_m_p_f_m_t, and the value 16 in the
location _s_a_m_p_w_i_d_t_h.
You can use the sample width value to determine the data type used to
pass samples to aaaaffffWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss(3dm), or to obtain samples from
1-8 bit samples are packed into signed cccchhhhaaaarrrrssss, 9-16 bit samples are packed
into sssshhhhoooorrrrttttssss, and 17-32 bit samples are packed into iiiinnnntttteeeeggggeeeerrrrssss or ffffllllooooaaaattttssss,
depending on the _s_a_m_p_f_m_t, and 64-bit samples are stored into ddddoooouuuubbbblllleeeessss.
SGI has proposed an extension to the AIFF-C format which will allow files
to store linear PCM samples as scaled IEEE floats or doubles in addition
to two's complement integers.
EEEEXXXXAAAAMMMMPPPPLLLLEEEE
If aaaaffffGGGGeeeettttSSSSaaaammmmpppplllleeeeFFFFoooorrrrmmmmaaaatttt(((()))) returns the value 8 in _s_a_m_p_w_i_d_t_h, and
AAAAFFFF____SSSSAAAAMMMMPPPPFFFFMMMMTTTT____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD in _s_a_m_p_f_m_t, allocate an uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr buffer for
reading samples from a file via aaaaffffRRRReeeeaaaaddddFFFFrrrraaaammmmeeeessss(3dm).
If aaaaffffGGGGeeeettttSSSSaaaammmmpppplllleeeeFFFFoooorrrrmmmmaaaatttt(((()))) returns the value 13 in _s_a_m_p_w_i_d_t_h and
AAAAFFFF____SSSSAAAAMMMMPPPPFFFFMMMMTTTT____TTTTWWWWOOOOSSSSCCCCOOOOMMMMPPPP in _s_a_m_p_f_m_t, allocate a (signed) sssshhhhoooorrrrtttt buffer for
reading samples from the file.
CCCCAAAAVVVVEEEEAAAATTTTSSSS
Note that this library will continue to support new file formats and thus
other data formats than the ones described above. Since the Audio File
Library is a Dynamic Shared Object (DSO), it is possible for this call to
return a sampfmt value not found in <aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh> at the time of
programming. Programs should be written to at least reject files with
